home *** CD-ROM | disk | FTP | other *** search
/ The Fatted Calf / The Fatted Calf.iso / Applications / GraphicViewers / pCD / Source / README.txt < prev   
Text File  |  1993-01-11  |  3KB  |  66 lines
  1.                                     pCD
  2.                              A Photo CD Viewer
  3.  
  4.                                Hadmut Danisch
  5.                             (danisch@ira.uka.de)
  6.  
  7.                                 Dick Phillips
  8.                                 (rlp@lanl.gov)
  9.  
  10. [ ******* 
  11.   Note that this README file has not been updated for version 0.2, it describes
  12.   version 0.1 from Dick Phillips.  Version 0.2 includes a number of changes,
  13.   done by Garance Drosehn.  See the PCD.README file for some details on 0.2
  14.   ******* ]
  15.  
  16. Thanks to Hadmut Danisch of the University of Karlsruhe, who deciphered Kodak's 
  17. Photo CD file format by reverse engineering, I have been able to put together a 
  18. Photo CD viewer for the NeXT.  The app ain't perfect and there still lurks a 
  19. bug or two, but I wanted get it out to beat the Christmas rush.  In addition to
  20. my source code for the user interface, I have included Hadmut's original 
  21. software, hpcdtoppm (v0.3).
  22.  
  23. I assume the directory structure for all Photo CDs are the same, but my 
  24. experience is limited to quantity one.  In particular, pCD assumes that at the 
  25. volume root level there will be a file with the name overview.pcd, and a 
  26. directory entitled images.  Under this directory there are an indeterminate 
  27. number of files, each with a name of the form imgnnnn.pcd, where nnnn is a four 
  28. digit sequence number.  If your Photo CD is structured differently, make 
  29. appropriate changes to the Controller class.
  30.  
  31. When pCD launches it requests a Photo CD volume name.  Then by reading the 
  32. overview.pcd file, it produces a window showing thumbnails of the images in the 
  33. images directory.  Each thumbnail is a button, which when clicked, reads and 
  34. displays the base (512 x 768) size of the image.  By looking at my code and 
  35. Hadmut's program, you can modify pCD to bring up all the image sizes available.  
  36. They are:
  37.  
  38.     base/16    128 x 192
  39.     base/4    256 x 384
  40.     base    512 x 768    (supported by pCD)
  41.     4base    1024 x 1536
  42.     16base    2048 x 3072
  43.     
  44. If I get time next year, I may add support for other sizes.  If you beat me to 
  45. it, please share your improvements with the world.  One other thing — although 
  46. all thumbnails appear in landscape format, the selected images will be 
  47. displayed appropriately.
  48.  
  49. Once you open an image, you can:
  50.  
  51. 1)    Save it as a TIFF, EPS, or JPEG file.
  52.  
  53. 2)    Rubber-band out a rectangular region region of the image and copy it
  54.   to the pasteboard.  If you then issue a paste command, an new window will
  55.   open containing the subimage.  Alternately, you can paste the subimage into
  56.   any application that accepts the above formats.
  57.     
  58. 3)    Print either just the image or the image with the enclosing window
  59.   frame.  Be careful! Only the Print and Cancel buttons work correctly.
  60.   (Perhaps someone will finish off the printing code).
  61.     
  62.     
  63.         Have fun!
  64.         
  65.         Dick Phillips
  66.         rlp@lanl.gov